home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / shells / tcsh6033.zoo / tcsh-603.pl3 / README.ST < prev    next >
Encoding:
Text File  |  1993-06-06  |  9.3 KB  |  210 lines
  1. tcsh 6.03.00 for MiNT
  2. ported by Michael Hohmuth <hohmuth@freia.inf.tu-dresden.de>
  3.  
  4. Distribution PL 03
  5. 05 May 1993
  6.  
  7. The description of the MiNT port follows after the original copyright notice:
  8.  
  9. -------------------------------------------------------------------------------
  10.  
  11.  Copyright (c) 1980,1991 The Regents of the University of California.
  12.  All rights reserved.
  13.  
  14.  Redistribution and use in source and binary forms, with or without
  15.  modification, are permitted provided that the following conditions
  16.  are met:
  17.  1. Redistributions of source code must retain the above copyright
  18.     notice, this list of conditions and the following disclaimer.
  19.  2. Redistributions in binary form must reproduce the above copyright
  20.     notice, this list of conditions and the following disclaimer in the
  21.     documentation and/or other materials provided with the distribution.
  22.  3. All advertising materials mentioning features or use of this software
  23.     must display the following acknowledgement:
  24.         This product includes software developed by the University of
  25.         California, Berkeley and its contributors.
  26.  4. Neither the name of the University nor the names of its contributors
  27.     may be used to endorse or promote products derived from this software
  28.     without specific prior written permission.
  29.  
  30.  THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  31.  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  32.  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  33.  ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  34.  FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  35.  DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  36.  OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  37.  HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  38.  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  39.  OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  40.  SUCH DAMAGE.
  41.  
  42. -------------------------------------------------------------------------------
  43.  
  44. This is my (Michael Hohmuth's) port of tcsh 6.03.00 to MiNT (_not_ TOS).
  45.  
  46. This file only describes the special features of the MiNT version.  For 
  47. documentation refer to the manual pages.
  48.  
  49. Manifest:
  50.  
  51.         ARGV.TXT        - a proposal for an ARGV standard extension that
  52.                           adds support for empty parameters
  53.         FAQ             - Frequently Asked Questions about tcsh
  54.         Fixes           - what has been fixed since the last version of tcsh
  55.         NewThings       - what's new in this version of tcsh
  56.         README          - original README from the tcsh distribution
  57.         README.ST       - this file
  58.         complete.tcsh   - examples on how to use tcsh's completition feature
  59.         csh.1           - csh manual
  60.         csh.man         - csh manual in roff format
  61.         diffs           - context diffs for tcsh for MiNT
  62.         tcsh            - tcsh binary for MiNT (rename it to tcsh.ttp if
  63.                           you want)
  64.         tcsh.1          - tcsh manual
  65.         tcsh.man        - tcsh manual in roff format
  66.  
  67. Special features of the MiNT version:
  68.  
  69.         o   The version of `tcsh.ttp' in this distribution has been 
  70.             configured to support DOS file systems in the following two 
  71.             aspects:
  72.  
  73.             (1) tcsh's builtins support DOS file names with drive 
  74.                 specifications and backslashes. However, note that you 
  75.                 have to escape backslashes with another backslash: "\\"
  76.  
  77.             (2) tcsh uses DOS compatible file names for its 
  78.                 configuration files:
  79.  
  80.                 UNIX file name      DOS file name
  81.  
  82.                 .history            history.csh
  83.                 .cshdirs            cshdirs.csh
  84.                 .tcshrc             tcshrc.csh
  85.                 .cshrc              cshrc.csh
  86.                 .login              login.csh
  87.                 .logout             logout.csh
  88.                 /etc/csh.cshrc      /etc/cshrc.csh
  89.                 /etc/csh.login      /etc/login.csh
  90.                 /etc/csh.logout     /etc/logout.csh
  91.  
  92.         o   This version of `tcsh.ttp' also has been configured to strip 
  93.             CRs (0x0d) from line endings.
  94.  
  95.         o   The MiNT version of tcsh supports a list of suffixes which 
  96.             executable files can have.  This list is initially taken 
  97.             from the environment variable "SUFFIXES"; if this variable 
  98.             does not exist, it defaults to "ttp,prg,tos,app,gtp,csh,".
  99.  
  100.         o   `tcsh.ttp' has been linked with the MiNT Library PatchLevel 
  101.             pre-31.  That means that it has the following additional 
  102.             feature:
  103.  
  104.             All environment variables which are listed in the environment 
  105.             variable "PCONVERT" will be converted from a DOS style path 
  106.             list to a Unix style one.  If "PCONVERT" does not exist, it 
  107.             defaults to "PATH".  Please note that setting PCONVERT from
  108.             inside tcsh has no effect on the other environment variables
  109.             (except when spawning, when the variables will be converted
  110.             back to TOS style).  So make sure that PCONVERT has been
  111.             initialized before you enter tcsh (e.g. set in in your mint.cnf 
  112.             file).
  113.  
  114.             I suggest you use at least the following setup for "PCONVERT": 
  115.             "PATH,HOME,SHELL,CDPATH".
  116.  
  117.         o   Support for empty (i.e., zero length) command line parameters
  118.             has been included, according to a proposed extension to Atari's
  119.             ARGV standard (see ARGV.TXT for details).  That means that
  120.             `tcsh' can accept and pass empty parameters given that the
  121.             calling/called program also supports the ARGV standard
  122.             extension.  (Hopefully, one of the next mntlib PatchLevels will
  123.             contain support for this.)
  124.  
  125.         o   The "autolock" feature works exactly like "autologout", because
  126.             the MiNT library doesn't support password encryption.
  127.  
  128.         o   `tcsh.ttp' has been compiled with GCC 2.3.3 pl 2 and the
  129.             "-mbaserel" option so that it is sharable under MiNT.
  130.  
  131. Credits:
  132.  
  133.         This port is mainly based on Eric Smith's port of tcsh 6.00.02 
  134.         to MiNT.  I just straightforwardly applied Eric's changes, fixed 
  135.         a few bugs, added a few features (and removed some) and added 
  136.         support for 6.03.  (For a list of differences from Eric's 
  137.         port, see below.)  Thanks, Eric!
  138.  
  139. Enjoy!
  140.  
  141. Michael Hohmuth
  142.  
  143. hohmuth@freia.inf.tu-dresden.de
  144. mh1@irz.inf.tu-dresden.de
  145.  
  146.  
  147. --------------------------------------------------------------------------
  148.  
  149. APPENDIX
  150.  
  151. Differences from Eric Smith's port of tcsh 6.00.02:
  152.  
  153.         o   My port does not support the shell variables "escchar" and 
  154.             "dosslashes".  That means that it's not possible to redefine 
  155.             the shell's escape character and use single backslashes as 
  156.             path separators (use escaped backslashes instead), and the 
  157.             shell always outputs "/" as the path separator.
  158.  
  159.         o   Eric renamed the file `.cshrc' to `csh.rc'.  I named it 
  160.             `cshrc.csh' because this seemed more logical to me.
  161.  
  162.         o   My version will not run under plain TOS, only under MiNT.
  163.  
  164. Differences from my port of tcsh 6.02.00:
  165.  
  166.         o   6.02 did not handle scripts correctly:  /bin/sh had been 
  167.             invoked for any script, no matter what the "#!" line said.
  168.             This is fixed in this version.
  169.  
  170.         o   6.02 was configured to use sbrk() instead of malloc() and to
  171.             expect continuus memery.  That's why all allocations had to
  172.             happen from the stack, which had to be quite large (128K)
  173.             for that reason.
  174.             6.03 now uses malloc(), and the stack has a "normal" size (20K).
  175.             (You can still use fixstk.ttp to change the stack size.)
  176.             
  177.         o   We now use the PCONVERT environment variable instead of
  178.             PATHCONV.  I had to change this because of a bug in old
  179.             versions of GEM (which interpretes the contents of "PATHCONV"
  180.             as its file search path).
  181.             
  182.  
  183. If you want to re-compile tcsh for MiNT:
  184.  
  185.         You can only build tcsh on a non-TOS file system.  Also, you 
  186.         need good versions of `sh', `egrep', and `sed', which are used 
  187.         during the build process.  (If you're cross-compiling on a Unix
  188.         host, this should not be a problem.)
  189.  
  190.         You have to get `tcsh-6.03.00.tar.Z' and apply to it the patches in 
  191.         the file `diffs' from this distribution.
  192.  
  193.         Edit the `Makefile' to suit your taste.
  194.  
  195.         You might also want to have a look at `config_f.h', where 
  196.         several features can be turned on or off.  The MiNT version has 
  197.         these additional features, which are turned on by default:
  198.  
  199.         o   If you define DOSFS, tcsh's builtins will support DOS file 
  200.             names with drive specifications (like "a:") and backslashes 
  201.             (which have to be escaped, like "\\").  Also, tcsh will use 
  202.             DOS compatible names for its configuration files   
  203.             (`login.csh' instead of `.login', for instance; see above 
  204.             for a complete list of affected file names).
  205.  
  206.         o   If you define DOSTEXT, tcsh will try to strip CRs from line 
  207.             endings in text files.  This will allow you to use scripts 
  208.             which have DOS line endings in them.
  209.  
  210.